home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / text / hyper / ppguide.lha / ppguide.doc < prev    next >
Text File  |  1993-05-14  |  3KB  |  95 lines
  1. PPguide v1.0 Documentation (5/14/93):
  2.  
  3. WHAT IT DOES:
  4.  
  5. PPguide shows both PowerPacked and normal .guide files.
  6.  
  7. WHY THIS PROGRAM EXISTS:
  8.  
  9. .guide files are often quite large (100K is normal).  They can be
  10. PowerPacked down to about a third of their size, saving a lot of disk space.
  11. Now they can be packed and viewed!
  12.  
  13. REQUIREMENTS:
  14.  
  15. This program should run under 1.3, but I've only tested it under 2.1.
  16.  
  17. PPguide requires Commodore's amigaguide.library and Nico François' excellent
  18. powerpacker.library (both should be in LIBS:).  I'm not including either
  19. file with this archive.  Why?  Distributing amigaguide.library requires
  20. filling out some silly paperwork, which I don't feel like doing.  And
  21. powerpacker.library keeps getting upgraded, so any version I included might
  22. well be out of date.  Both libraries are widely available from PD sources.
  23.  
  24. It is highly recommended that T: be assigned to Ram:t.  This is not
  25. required, but it'll certainly speed things up.  Most startup-sequences
  26. already do this.
  27.  
  28. PPguide is fairly memory-hungry (it does give it back, though!).
  29.  
  30. INSTALLATION:
  31.  
  32. Copy ppguide to your C: directory (or anywhere in your path).
  33.  
  34. USE:
  35.  
  36. From the shell, type:
  37.  
  38.   ppguide <file>
  39.  
  40. where <file> is the name of the file to view.  You can leave off the .pp
  41. suffix (if one exists).
  42.  
  43. From Workbench, there are two ways to run ppguide.  The first is to copy
  44. ppguide into C: and then double-click on a project icon which has a default
  45. tool of ppguide.  The second is to click on a project icon, then hold down
  46. either shift key and double-click on ppguide's icon (or vice versa).
  47.  
  48. DISKMASTER II USE:
  49.  
  50. Edit your Startup.DM file and add the following line in your AddCmd area:
  51.  
  52.   AddCmd ppguide, 20, ScrBack;extern c:ppguide %s;ScrFront
  53.  
  54. The 20 can be changed; that's just the colors to use.
  55.  
  56. Quit and reload DiskMaster, if it's running.
  57.  
  58. KNOWN BUGS/PROBLEMS/MISSING FEATURES:
  59.  
  60. PPguide really is a horrible kludge.  It decrunches the .guide file, then
  61. saves it to a temporary file in T:.  It then deallocates the buffer memory,
  62. then shows the .guide via amigaguide.library.  It would be so much cooler to
  63. show the buffer directly, but I haven't figured out how to do that yet.  I'm
  64. open to suggestions.
  65.  
  66. PROGRAMMER STUFF:
  67.  
  68. PPguide was compiled with Manx Aztec C 5.2a.  With a few minor changes, it
  69. should compile under SAS.  (Note:  my makefile is looking for a pre-compiled
  70. header file called Cheddar.)
  71.  
  72. This program has been tested with Enforcer and MungWall.
  73.  
  74. LEGAL STUFF:
  75.  
  76. PPguide is Copyright ©1993 William E. Sorensen.  All rights reserved.
  77.  
  78. Permission is granted to freely distribute and modify this program for non-
  79. commercial purposes only.
  80.  
  81. This program comes with ABSOLUTELY NO WARRANTY; without even the implied
  82. warranty of merchantability or fitness for a particular purpose.  Use it at
  83. your own risk.
  84.  
  85. THE AUTHOR:
  86.  
  87. Please send bug reports, comments, suggestions, and job offers to:
  88.  
  89.     Bill Sorensen
  90.     1415 Wisconsin St.
  91.     LeClaire, IA   52753
  92.  
  93.     Portal:  RevTetra
  94.     Internet:  RevTetra@cup.portal.com
  95.